This subsystem assigns names and measurement parameters to traces. The commands are device-specific.
Command tree: CALCulate<Ch>:PARameter
Returns the trace names and measurement parameters of all traces assigned to a particular channel.
|
<Ch> |
Channel number. If unspecified the numeric suffix is set to 1.
|
|
Response |
String parameter with comma-separated list of trace names and measurement parameters, e.g. 'CH4TR1,S11,CH4TR2,S12'. The measurement parameters are returned according to the naming convention of CALCulate<Ch>:PARameter:SDEFine. The order of traces in the list reflects their creation time: The oldest trace is the first, the newest trace is the last trace in the list.
|
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, query only.
|
|
Example: |
CALC4:PAR:SDEF 'Ch4Tr1', 'S11' Create channel 4 and a trace named Ch4Tr1 to measure the input reflection coefficient S11. CALC4:PAR:CAT? Query the traces assigned to channel 4. If Ch4Tr1 is the only trace assigned to channel 4, the response is 'CH4TR1,S11'.
|
Creates a trace and assigns a channel number, a name and a measurement parameter to it. The trace is not displayed. To display a trace defined via CALCulate<Ch>:PARameter:DEFine, a window must be created (DISPlay:WINDow<Wnd>[:STATe] ON) and the trace must be assigned to this window (DISPlay:WINDow<Wnd>:TRACe:FEED); see example below.
Traces must be selected to become active traces; see CALCulate:PARameter:SELect.
This
command has been implemented for compatibility reasons. The parameter
names in this command differ from ZVA conventions; moreover the parameter
list is not complete. The alternative command CALCulate<Ch>:PARameter:SDEFine
uses a complete parameter list with compatible names.
|
<Ch> |
Channel number. <Ch> may be used to reference a previously defined channel. If <Ch> does not exist, it is generated with default channel settings.
|
|
'<string>' |
Trace name, e.g. 'Trc4'. See Rules for trace names in the Trace Manager description.
|
|
S11, ... R4R3 |
Measurement parameter; see list of parameters below. |
|
*RST value |
–
|
|
[<numeric_value>] |
Test port number, ignored in the current firmware version. |
|
Range [def. unit] |
1 to 4 [–] (depending on instrument model) |
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, no query. CALCulate<Ch>:PARameter:CATalog? returns a list of all defined traces.
|
|
Example: |
CALC4:PAR:DEF 'Ch4Tr1', S11 Create channel 4 and a trace named Ch4Tr1 to measure the input reflection coefficient S11. DISP:WIND:STAT ON Create diagram area no. 1. DISP:WIND:TRAC:FEED 'CH4TR1' Display the generated trace in diagram area no. 1.
|
The measurement parameter is selected by means of the following keywords (the selection depends on the number of test ports of the analyzer, e.g. S44 is not available on 2-port analyzers):
|
S11 | S12 | S13 | S14 | S21 | S22 | S23 | S24 | S31 | S32 | S33 | S34 | S41 | S42 | S43 | S44 |
S-parameters |
|
A | B | C | D |
Wave quantities b1, b2, b3, b4 (received waves) |
|
R1 | R2 | R3 | R4 |
Wave quantities a1, a2, a3, a4 (reference waves) |
|
AB | AC | AD | BA | BC | BD | CA | CB | CD | DA | dB | DC |
Ratio of wave quantities b1/b2, b1/b3, ... , b4/b3 (received waves only) |
|
AR1 | AR2 | AR3 | AR4 | BR1 | BR2 | BR3 | BR4 | CR1 | CR2 | CR3 | CR4 | DR1 | DR2 | DR3 | DR4 | R1A | R1B | R1C | R1D | R2A | R2B | R2C | R2D | R3A | R3B | R3C | R3D | R4A | R4B | R4C | R4D |
Ratio of wave quantities b1/a1, b1/a2, ... , b4/a4, a1/b1, a1/b2, ..., A4/B4 (received waves to reference waves or reference waves to received waves) |
|
R1R2 | R1R3 | R1R4 | R2R1 | R2R3 | R2R4 | R3R1 | R3R2 | R3R4 | R4R1 | R4R2 | R4R3 |
Ratio of wave quantities a1/a2, a1/a3, ... , a4/a3 (reference waves only) |
Deletes a trace with a specified trace name and channel.
|
<Ch> |
Channel number.
|
|
'<string>' |
Trace name, e.g. 'Trc4'. See Rules for trace names in the Trace Manager description.
|
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, no query.
|
|
Example: |
CALC4:PAR:SDEF 'Ch4Tr1', 'S11' Create channel 4 and a trace named Ch4Tr1 to measure the input reflection coefficient S11. CALC4:PAR:CAT? Query the traces assigned to channel 4. If Ch4Tr1 is the only trace assigned to channel 4, the response is 'CH4TR1,S11'. CALC4:PAR:DEL 'CH4TR1' Delete the created trace.
|
Assigns a measurement parameter to an existing trace.
Note: To create a new trace and at the same time assign the attributes, use CALCulate<Ch>:PARameter:SDEFine. To display the trace, create a window (DISPlay:WINDow<Wnd>[:STATe] ON) and assign the trace to this window (DISPlay:WINDow<Wnd>:TRACe:FEED); see example below.
Traces must be selected to become active traces; see CALCulate:PARameter:SELect. CALCulate<Ch>:PARameter:CATalog? returns a list of all defined traces. You can open the trace manager (DISPlay:MENU:KEY:EXECute 'Trace Manager') to obtain an overview of all channels and traces, including the traces that are not displayed.
|
<Ch> |
Channel number of an existing channel containing the referenced trace.
|
|
'<string>' |
Trace name, e.g. 'Trc4'. See Rules for trace names in the Trace Manager description.
|
|
'S11', ... |
Measurement parameter (string variable); see list of in
the CALCulate<Ch>:PARameter:SDEFine
command description. |
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, with query (see 'S11',... parameter description above).
|
|
Example: |
CALC4:PAR:SDEF 'Ch4Tr1', 'S11' Create channel 4 and a trace named Ch4Tr1 to measure the input reflection coefficient S11. CALC4:PAR:MEAS 'Ch4Tr1', 'a1' Change the measurement parameter of the trace and measure the wave quantity a1. CALC4:PAR:MEAS? 'Ch4Tr1' Query the measured quantity. The response is 'A1D1SAM'.
|
Creates a trace and assigns a channel number, a name and a measurement parameter to it. The trace becomes the active trace in the channel but is not displayed.
To
display the trace defined via CALCulate<Ch>:PARameter:SDEFine,
create a window (DISPlay:WINDow<Wnd>[:STATe]
ON)
and assign the trace to this window (DISPlay:WINDow<Wnd>:TRACe:FEED);
see example below. CALCulate<Ch>:PARameter:MEASure
changes the measurement parameter of an existing trace.
To select an existing trace as the active trace, use CALCulate:PARameter:SELect. You can open the trace manager (DISPlay:MENU:KEY:EXECute 'Trace Manager') to obtain an overview of all channels and traces, including the traces that are not displayed.
In
FW versions <V1.90, traces created with CALCulate<Ch>:PARameter:SDEFine
must be selected explicitly (CALCulate:PARameter:SELect)
in order to become active traces.
|
<Ch> |
Channel number. <Ch> may be used to reference a previously defined channel. If <Ch> does not exist, it is generated with default channel settings.
|
|
'<string>' |
Trace name, e.g. 'Trc4'. See Rules for trace names in the Trace Manager description.
|
|
'S11', ... |
Measurement parameter (string variable); see list of parameters below. |
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, no query. CALCulate<Ch>:PARameter:MEASure? '<Trc_name>' queries the measurement parameter of the trace. CALCulate<Ch>:PARameter:CATalog? returns a list of all defined traces.
|
|
Example: |
CALC4:PAR:SDEF 'Ch4Tr1', 'S11' Create channel 4 and a trace named Ch4Tr1 to measure the input reflection coefficient S11. DISP:WIND2:STAT ON Create diagram area no. 2. DISP:WIND2:TRAC:FEED 'CH4TR1' Display the generated trace in diagram area no. 2.
|
The measurement parameter is selected by means of the following keywords (the selection depends on the number of test ports of the analyzer, e.g. S44 is not available on 2-port analyzers):
|
'S11' | 'S12' | ... | 'S0101' | ... |
Normal mode S-parameters S<out><in>, where <out> and <in> denote the output and input port numbers of the DUT. To avoid ambiguities, <out> and <in> must be either both 1-digit numbers (e.g. 21) or both 2-digit numbers (e.g. 2121 or 0133). |
|
'SCD11' | |
Mixed mode S-parameters S<mout><m in>, where <mout> and <min> denote the output and input port modes. All combinations of S (single-ended, unbalanced), D (differential) and C (common) are allowed. Port numbers like for normal mode S-parameters. |
|
'Y11' | ... | 'YSS11' | ... | 'YCC11' | ... | 'YDD11' | 'Z11' | ... | 'ZSS11' | ... | 'ZCC11' | ... | 'ZDD11' | ... |
Short-circuit Y-parameters and open-circuit Z-parameters with port modes and port numbers like for normal mode S-parameters*). |
|
'Y-S11' | ... | 'Y-SSS11' | ... | 'Y-SCC11' | ... | 'Y-SDD11' | 'Z-S11' | ... | 'Z-SSS11' | ... | 'Z-SCC11' | ... | 'Z-SDD11' | ... |
S-parameters converted to matched-circuit admittances and impedances with port modes and port numbers like for normal mode S-parameters. |
|
'a1' | ... | 'a01' | ... | 'B1' | ... | 'B01' | ... | 'a1SAM' | 'a1RMS' | 'a1PEAK' | |
Wave quantities with port numbers like for normal mode S-parameters. The strings SAM, RMS, PEAK appended to the wave quantities denote a normal (sample), RMS or peak detector. The observation time for RMS and peak detectors is set via [SENSe<Ch>:]SWEep:DETector:TIME. |
|
'a1D2' | ... | 'a01D2' | ... | 'B1D2' | ... | 'B01D2' | ... | 'a1D1SAM' | 'a1D1RMS' | 'a1D1PEAK' | ... |
Wave quantities with port numbers and source port numbers (D<no> for drive port). The strings SAM, RMS, PEAK appended to the wave quantities denote a normal (sample), RMS or peak detector. |
|
'a1G2' | ... | 'a01G2' | ... | 'B1G2' | ... | 'B01G2' | ... | 'a1G1SAM' | 'a1G1RMS' | 'a1G1PEAK' | ... |
Wave quantities with port numbers and external generator providing the stimulus signal (G<no> for generator no.). The strings SAM, RMS, PEAK appended to the wave quantities denote a normal (sample), RMS or peak detector. |
|
'b2/a1' | ... 'b02/a01' | ... | 'b2/a1SAM' | 'b2/a1RMS' | 'b2/a1PEAK' | ... |
Ratio of wave quantities with port numbers like for normal mode S-parameters. The strings SAM, RMS, PEAK appended to the wave quantities denote a normal (sample), RMS or peak detector. |
|
'b2D1/a1D1' | ... 'b02D1/a01D1' | ... 'b2D1/a1D1SAM' | 'b2D1/a1D1RMS' | 'b2D1/a1D1PEAK' | ... |
Ratio of wave quantities with port numbers and source port numbers (D<no> for drive port). The strings SAM, RMS, PEAK appended to the wave quantities denote a normal (sample), RMS or peak detector. |
|
'b2G1/a1G1' | ... 'b02G1/a01G1' | ... 'b2G1/a1G1SAM' | 'b2G1/a1G1RMS' | 'b2G1/a1G1PEAK' | ... |
Ratio of wave quantities with port numbers and external generator providing the stimulus signal (G<no> for generator no.). The strings SAM, RMS, PEAK appended to the wave quantities denote a normal (sample), RMS or peak detector. |
|
'IMB21' | 'IMB12' | 'IMB31' | ... |
Imbalance parameter for balanced ports Imb<receive_port><drive_port>. The indices denote the logical receive port and the logical drive port of the analyzer. |
|
'KFAC21' | 'KFAC12' | ... |
Stability factor K (for unbalanced ports only) |
|
'MUF121' | 'MUF112' | ... |
Stability factor m1 (for unbalanced ports only) |
|
'MUF221' | 'MUF212' | ... |
Stability factor m2 (for unbalanced ports only) |
|
'PAE21' | PAE12' | |
Power added efficiency |
|
'DC1V' | 'DC10V' |
DC MEAS |
|
'Pmtr1G1' | 'Pmtr2G1' | 'Pmtr3D1' |
Power sensor measurement using a power meter 'Pmtr<n>' and either an external generator 'G<n>' or an analyzer source port 'D<n>' |
*)Selecting a parameter Y...<n><m> or Z...<n><m> sets the range of port numbers to be considered for the Y and Z-parameter measurement to <n>:<m>.
Selects an existing trace as the active trace of the channel. All trace commands without explicit reference to the trace name act on the active trace (e.g. CALCulate<Ch>:FORMat). CALCulate<Ch>:PARameter:SELect is necessary e.g. if the active trace of a channel has been deleted.
|
<Ch> |
Channel number.
|
|
<string> |
Trace name, e.g. 'Trc4'. See Rules for trace names in the Trace Manager description.
|
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, with query (returns the name of the active trace).
|
|
Example: |
CALC4:PAR:SDEF 'Ch4Tr1', 'S11' Create channel 4 and a trace named Ch4Tr1 to measure the input reflection coefficient S11. The trace is the active trace in channel 4. CALC4:PAR:SDEF 'Ch4Tr2', 'S22' Create another trace named Ch4Tr2 to measure the output reflection coefficient S22. Again this new trace becomes the active trace in channel 4. CALC4:PAR:SEL 'Ch4Tr1' Select the first trace Ch4Tr1 as the active trace. CALC4:FORM MLIN Calculate the magnitude of S11 and display it in a linearly scaled Cartesian diagram.
|
1V' or 'DC